home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 7 / PC World Interactive 7.iso / pcgames / EMERGY / BC5 / EXAMPLES / OWL / CLASSES / ANIMCTL / readme.txt
Text File  |  1997-03-25  |  3KB  |  88 lines
  1. ObjectWindows 
  2. Copyright (c) 1996 Borland International
  3.  
  4. Title: ANIMCTL EXAMPLE
  5.  
  6. Keywords: TAnimateCtl;Common Control
  7.  
  8. TAnimateCtrl, an Introduction
  9. =============================
  10. TAnimateCtrl encapsulates the animation control fo the Common
  11. Control library. The control is a window that silently displays
  12. an AVI (Audio Video Interleaved) clip. 
  13. NOTE: The animation control can only play silent clips from an
  14. uncompressed .AVI file or from an .AVI file that was compressed
  15. using run-length encoding (RLE).
  16.  
  17.  
  18. Creating a TAnimateCtrl Object
  19. ==============================
  20. TAnimateCtrl provides two constructors:
  21.   1. TAnimateCtrl(parent, id, x, y, w, h, module);
  22.   2. TAnimateCtrl(parent, resourceId, module);
  23.  
  24. The first one can be used to create a brand new control. For
  25. example, you may use the following syntax within the constructor
  26. of a parent window:
  27.  
  28.     TClientWindow::TClientWindow(TWindow* parent) : TWindow(parent)
  29.     {
  30.         AnimateCtrl = new TAnimateCtrl(this, 0x100, 5, 10, 50, 60);
  31.     };
  32.  
  33. The above snippet instruct ObjectWindows to create an animation
  34. control with the ID of 0x100, at location (5,10), 50 pixels wide
  35. and 60 pixels high within the client area of the TClientWindow
  36. window.
  37.  
  38. The other constructor of the TAnimateCtrl class is used to alias
  39. an animation control which is part of a dialog resource. The following
  40. resource definition illustrates a dialog containing an animation
  41. control:
  42.  
  43. IDD_ANIMATE DIALOG 45, 56, 176, 99
  44. STYLE DS_MODALFRAME | WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU
  45. CAPTION "Animation Dialog"
  46. {
  47.  CONTROL "Sample_Avi", IDC_ANIMATE, "SysAnimate32", ACS_CENTER | ACS_TRANSPARENT | WS_CHILD | WS_VISIBLE | WS_BORDER, 16, 10, 145, 61
  48. }
  49.  
  50. The following snippet illustrates how to alias an animation
  51. control within a TDialog-derived class' constructor:
  52.  
  53.     TAnimDialog::TAnimDialog(TWindow* parent, TResId res) 
  54.                 :TDialog(parent, res)
  55.     {
  56.         AnimCtrl = new TAnimateCtrl(this, IDC_ANIMATE);
  57.     }
  58.  
  59.  
  60. Using the TAnimateCtrl Object
  61. =============================
  62. After creating an animation control you can invoke the 'Open'
  63. method to open an AVI clip and load it in memory. The following
  64. code illustrates:
  65.  
  66.   AnimateCtrl->Open(MAKEINTRESOURCE(SAMPLE_ONE));
  67.  
  68. NOTE: The parameter to the 'Open' method can contain the path to
  69. an .AVI file or the name of an AVI resource.
  70.  
  71. The 'Play' method of TAnimateCtrl plays the current AVI clip in
  72. the animation window. Note that the control plays the clip in
  73. the background while the thread continues executing.
  74.  
  75. The 'Seek' method allows you to seek to a particular frame of
  76. the current .AVI clip while the 'Stop' method stops playing any
  77. .AVI clip.
  78.  
  79.  
  80. Additional Information
  81. ======================
  82. 1. The specified caption of the control may contain the name of
  83. an .AVI resource to be opened automatically be the control.
  84.  
  85. 2. Passing '-1' as the third argument to the 'Play' method
  86. instructs the control to replay the clip indefinitely.
  87.  
  88.